Inside Macintosh: QuickDraw GX Objects /

Chapter 2 - Shape Objects / Shape Objects Reference

Functions / Manipulating Shape Object Properties

GXSetShapeStyle

You can use the GXSetShapeStyle function to change the style object associated with a QuickDraw GX shape.

void GXSetShapeStyle(gxShape target, gxStyle newStyle);

target

A reference to the shape whose style object is to be changed.

newStyle

A reference to the new style object to associate with the target shape.

DESCRIPTION

The GXSetShapeStyle function disassociates the style object already associated with the target shape and disposes of it. The function then assigns the style object referenced by the newStyle parameter to the target shape and increments by 1 the owner count of the new style object.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
shape_is_nil
style_is_nil
shape_access_not_allowed	(debugging version)
Notices (debugging version)
style_already_set

SEE ALSO

The relationship of style objects to QuickDraw GX shapes is discussed in "About QuickDraw GX Shapes" beginning on page 2-5. Style objects themselves are further discussed in the chapter "Style Objects" in this book.

To determine the style object associated with a QuickDraw GX shape, use the GXGetShapeStyle function, described in the previous section.